Developer Documentation

QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Managing Backfacing Styles

QuickDraw 3D provides routines that you can use to manage backfacing styles.

Q3BackfacingStyle_New

You can use the Q3BackfacingStyle_New function to create a new backfacing style object.

TQ3StyleObject Q3BackfacingStyle_New (
                     TQ3BackfacingStyle backfacingStyle);
backfacingStyle
A backfacing style value.

DESCRIPTION

The Q3BackfacingStyle_New function returns, as its function result, a new style object having the backfacing style specified by the backfacingStyle parameter. The backfacingStyle parameter should be one of these values:

kQ3BackfacingStyleBoth
kQ3BackfacingStyleRemove
kQ3BackfacingStyleFlip

If a new style object could not be created, Q3BackfacingStyle_New returns the value NULL .

To change the current backfacing style, you must actually draw the style object. You can call Q3Style_Submit to draw the style in retained mode or Q3BackfacingStyle_Submit (described next) to draw the style in immediate mode.

SEE ALSO

See "Backfacing Styles" for a description of the available backfacing styles.

Q3BackfacingStyle_Submit

You can use the Q3BackfacingStyle_Submit function to submit a backfacing style for drawing in immediate mode.

TQ3Status Q3BackfacingStyle_Submit (
                     TQ3BackfacingStyle backfacingStyle,
                     TQ3ViewObject view);
backfacingStyle
A backfacing style value.
view
A view.

DESCRIPTION

The Q3BackfacingStyle_Submit function sets the backfacing style of the view specified by the view parameter to the style specified in the backfacingStyle parameter.

SPECIAL CONSIDERATIONS

You should call Q3BackfacingStyle_Submit only in a submitting loop.

Q3BackfacingStyle_Get

You can use the Q3BackfacingStyle_Get function to get the backfacing style value of a backfacing style.

TQ3Status Q3BackfacingStyle_Get (
                     TQ3StyleObject backfacingObject,
                     TQ3BackfacingStyle *backfacingStyle);
backfacingObject
A backfacing style object.
backfacingStyle
On exit, a pointer to the backfacing style value of the specified backfacing style object.

DESCRIPTION

The Q3BackfacingStyle_Get function returns, in the backfacingStyle parameter, a pointer to the current backfacing style value of the backfacing style object specified by the backfacingObject parameter.

Q3BackfacingStyle_Set

You can use the Q3BackfacingStyle_Set function to set the backfacing style value of a backfacing style.

TQ3Status Q3BackfacingStyle_Set (
                     TQ3StyleObject backfacingObject,
                     TQ3BackfacingStyle backfacingStyle);
backfacingObject
A backfacing style object.
backfacingStyle
A backfacing style value.

DESCRIPTION

The Q3BackfacingStyle_Set function sets the backfacing style value of the style object specified by the backfacingObject parameter to the value specified in the backfacingStyle parameter.

© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |